home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / ilib_11.arj / ICONLIB.DOC < prev    next >
Text File  |  1993-04-09  |  21KB  |  527 lines

  1.  
  2.  
  3.  
  4.  
  5.                                  The Icon Librarian
  6.  
  7.                              Version 1.0   April 8, 1993
  8.  
  9.  
  10.  
  11.                                  _______
  12.                             ____|__     |               (tm)
  13.                          --|       |    |-------------------
  14.                            |   ____|__  |  Association of
  15.                            |  |       |_|  Shareware
  16.                            |__|   o   |    Professionals
  17.                          -----|   |   |---------------------
  18.                               |___|___|    MEMBER
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                         Copyright (c) 1993 by Keith Ledbetter
  25.                                  4240 Ketcham Drive
  26.                                Chesterfield, VA  23832
  27.                                    (804) 674-0780
  28.                            (6:00pm - 10:00pm Eastern Time)
  29.  
  30.  
  31.  
  32.                        Tech Support BBS:   Blue Ridge Express
  33.                                     804-790-1675
  34.                               30 Phone Lines (2400 bd)
  35.                                   Sub-board KEITHL
  36.                                     ("J KEITHL")
  37.  
  38.  
  39.  
  40.                                   Email Addresses:
  41.  
  42.                              GEnie         : ORION.MICRO
  43.                              Compuserve    :  72240,1221
  44.                              America Online:  kledbetter
  45.  
  46.  
  47.  
  48.  
  49.                   Program and Documentation are Copyright (c) 1993
  50.                       by Keith Ledbetter.  All rights reserved.
  51.  
  52.  
  53.  
  54.                          Portions (c) Borland International.
  55.             The Icon Librarian was written with Borland C++ Professional.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.             This program  is produced  by a  member of  the Association  of
  62.           Shareware Professionals (ASP).  ASP wants  to make sure that  the
  63.           shareware principle works for you. If you are unable to resolve a
  64.           shareware related problem  with an ASP  member by contacting  the
  65.           member directly, ASP may be able  to help. The ASP Ombudsman  can
  66.           help you resolve  a dispute or  problem with an  ASP member,  but
  67.           does not provide technical support for members' products.  Please
  68.           write to the ASP Ombudsman at PO. Box 5786, Bellevue, WA 98006 or
  69.           send  a  Compuserve  message   via  easyplex  to  ASP   Ombudsman
  70.           70007,3536.
  71.  
  72.  
  73.  
  74.                                Definition of Shareware
  75.  
  76.  
  77.  
  78.           Shareware distribution  gives  users  a chance  to  try  software
  79.           before buying it.   If you try a  Shareware program and  continue
  80.           using it,  you  are  expected to  register.  Individual  programs
  81.           differ on  details  --  some request  registration  while  others
  82.           require  it,   some  specify   a  maximum   trial  period.   With
  83.           registration, you get anything from the simple right to  continue
  84.           using the software to an updated program with printed manual.
  85.  
  86.           Copyright laws apply to  both Shareware and commercial  software,
  87.           and the copyright holder retains all rights, with a few  specific
  88.           exceptions as stated  below. Shareware  authors are  accomplished
  89.           programmers, just like commercial  authors, and the programs  are
  90.           of comparable quality.  (In both cases,  there are good  programs
  91.           and  bad  ones!)  The  main  difference  is  in  the  method   of
  92.           distribution. The author  specifically grants the  right to  copy
  93.           and distribute the  software, either to  all and sundry  or to  a
  94.           specific  group.  For  example,  some  authors  require   written
  95.           permission  before  a  commercial  disk  vendor  may  copy  their
  96.           Shareware.
  97.  
  98.           Shareware is a distribution method, not  a type of software.  You
  99.           should find  software  that  suits  your  needs  and  pocketbook,
  100.           whether it's commercial or Shareware. The Shareware system  makes
  101.           fitting your needs easier,  because you can  try before you  buy.
  102.           And because the overhead is low,  prices are low also.  Shareware
  103.           has the ultimate  money-back guarantee --  if you  don't use  the
  104.           product, you don't pay for it.
  105.  
  106.  
  107.  
  108.                                Disclaimer - Agreement
  109.  
  110.  
  111.  
  112.               Users of The Icon Librarian must accept this disclaimer of
  113.           warranty:
  114.  
  115.           "The Icon Librarian is supplied as is.  The author disclaims all
  116.           warranties, expressed or implied, including, without limitation,
  117.           the warranties of merchantability and of fitness for any purpose.
  118.           The author assumes no liability for damages, direct or
  119.           consequential, which may result from the use of The Icon
  120.           Librarian."
  121.  
  122.           The Icon Librarian is a "shareware program" and is provided at no
  123.           charge to the user for evaluation.  Feel free to share it with
  124.           your friends, but please do not give it away altered or as part
  125.           of another system.  The essence of "user-supported" software is
  126.           to provide personal computer users with quality software without
  127.           high prices, and yet to provide incentive for programmers to
  128.           continue to develop new products.  If you find this program
  129.           useful and find that you are using The Icon Librarian and
  130.           continue to use it after a reasonable trial period, you must make
  131.           a registration payment of $15 to Keith Ledbetter.  The $15
  132.           registration fee will license one copy for use on any one
  133.           computer at any one time.  You must treat this software just like
  134.           a book.  An example is that this software may be used by any
  135.           number of people and may be freely moved from one computer
  136.           location to another, so long as there is no possibility of it
  137.           being used at one location while it's being used at another.
  138.           Just as a book cannot be read by two different persons at the
  139.           same time.
  140.  
  141.           Commercial users of The Icon Librarian must register and pay for
  142.           their copies of the program within 30 days of first use or their
  143.           license is withdrawn.  Site-License arrangements may be made by
  144.           contacting Keith Ledbetter.
  145.  
  146.           You are encouraged to pass a copy of The Icon Librarian along to
  147.           your friends for evaluation.  Please encourage them to register
  148.           their copy if they find that they can use it.  All registered
  149.           users will receive a copy of the latest version of the Icon
  150.           Librarian system.
  151.  
  152.  
  153.  
  154.                                   About the Program
  155.  
  156.  
  157.  
  158.                If you are a  regular Windows user, then  you have no  doubt
  159.           had to struggle to keep up with the multitude of icons  available
  160.           today.   The Icon  Librarian  (Librarian) makes  manipulation  of
  161.           these icons easy;  you can categorize,  delete, and choose  icons
  162.           from up to 100  user-defined categories (with  up to 1,000  icons
  163.           each) with  intuitive drag-and-drop  operations.   The  Librarian
  164.           keeps its icons in space-efficient library files, so you'll  save
  165.           valuable disk  space, too.     Icons can  be imported  into  your
  166.           libraries from ICO, EXE, DLL, Norton  Library, and PC Tools  .ICL
  167.           files.
  168.  
  169.  
  170.  
  171.                Developers will also  find the  Librarian very  useful.   It
  172.           will allow you  to keep  your development  icons in  well-defined
  173.           categories (buttons, hardware, etc.)  without wasting disk  space
  174.           by having multitudes of small .ICO files on your hard drive.
  175.  
  176.  
  177.  
  178.              The Librarian works by keeping a master directory on your hard
  179.           drive named  \ICONLIB\.      All  of  your  library  files  (.TIL
  180.           extension) will be stored here.   In addition, a directory  named
  181.           \ICONLIB\IN_USE\ will also be created to hold any icons that  you
  182.           use with the "quick extract" features (more about this later).
  183.  
  184.  
  185.  
  186.                               Installing the Librarian
  187.  
  188.  
  189.  
  190.                To install  the Icon  Librarian,  copy the  ICONLIB.EXE  and
  191.           ICONLIB.HLP files to the directory of your choice.  Then, install
  192.           the ICONLIB.EXE file into the program  manager just as you  would
  193.           any other  Windows  program.   Next,  double-click  on  The  Icon
  194.           Librarian icon to load the program.
  195.  
  196.                The first time you execute the  Icon Librarian, you will  be
  197.           presented with an  "installation" screen.    All you  need to  do
  198.           here is to tell the Librarian which drive you'd like it to create
  199.           the \ICONLIB\ directory structure on.  Once you choose the  drive
  200.           letter and  press the  "Ok" button,  the  Librarian will  do  two
  201.           things:
  202.  
  203.                1.   It will create the \ICONLIB\ and \ICONLIB\IN_USE\
  204.                     directory structure on the drive you selected.
  205.  
  206.                2.   It will modify your WIN.INI file to add
  207.                     [The Icon Librarian] section to the system.
  208.  
  209.  
  210.                At this point,  you will be  presented with the  Librarian's
  211.           main screen.    The screen will look  bare at this point  because
  212.           you don't have  any library files  created yet.   As an  example,
  213.           we'll create a library (i.e.: a "category") that consists of  all
  214.           of the icons from your \Windows\ subdirectory.   Do these steps:
  215.  
  216.  
  217.           1.  From  the menu,  choose "File/New  Library" to  create a  new
  218.           library file.   You  will be  presented with  a dialog  box  that
  219.           allows you to  (a) give  this library a  name, and  (b) give  its
  220.           folder a color.    Key in "Windows Icons"  in the name field  and
  221.           pick a  color of  your choice.   You  can ignore  the  "filename"
  222.           field; if you don't key a filename in, the Librarian will  create
  223.           one for you.
  224.  
  225.           2.  Double-click the left mouse button on the new "Windows Icons"
  226.           folder that appeared in your main window.  This will "open"  that
  227.           library.
  228.  
  229.           3.  In the icon window, choose "File/Import icons" from the  menu
  230.           bar.  You  will be presented  with a file  open box; navigate  to
  231.           your \Windows\ directory and select all of the available files by
  232.           clicking on the "Select All" button.
  233.  
  234.           4.  You have just created your first icon library!
  235.  
  236.           5.  Repeat  these steps to  create libraries out  of all of  your
  237.           existing icons.
  238.  
  239.  
  240.  
  241.                                The "Preferences" Menu
  242.                                ----------------------
  243.  
  244.                Before we  go any  further,  let's cover  the  "Preferences"
  245.           menu.  The preferences are  divided into two categories:  Library
  246.           preferences and Icon preferences.
  247.  
  248.  
  249.           Specify Icon Editor
  250.  
  251.                This option allows you to specify  the icon editor that  you
  252.           want to use  to edit  icons.  The  only requirement  is that  the
  253.           editor you  choose must  support filenames  passed to  it on  the
  254.           command line.
  255.  
  256.  
  257.           Library / Confirm Deletes
  258.  
  259.                If this option is checked, the Librarian will prompt you for
  260.           verification when  you  attempt  to  delete  a  library.    Since
  261.           deleting a library also deletes all icons in that library, it  is
  262.           highly recommended that you keep this option turned on.
  263.  
  264.  
  265.           Library / Open Window upon Creation
  266.  
  267.           If this option is checked, the Librarian will automatically  open
  268.           up any new library that you create.
  269.  
  270.  
  271.           Library / Color of New Folders
  272.  
  273.           This setting allows you to specify  the default color to be  used
  274.           for libraries in the "File/New Folder" dialog box.
  275.  
  276.  
  277.           Icons / Confirm Deletes
  278.  
  279.           If this  option is  checked, the  Librarian will  prompt you  for
  280.           verification when you attempt to delete an icon.
  281.  
  282.  
  283.           Icons / Display While Importing
  284.  
  285.           If this option is checked, icons will be displayed in the library
  286.           window as soon as they are imported.  If you are importing  large
  287.           amounts of icons at one time, turning this option off will  speed
  288.           up the import process.
  289.  
  290.  
  291.  
  292.           Icons / Icon Spacing
  293.  
  294.                This option allows you to control the "white space" between
  295.           each icon in the library window.
  296.  
  297.  
  298.  
  299.                                     Moving Icons
  300.                                     ------------
  301.  
  302.                To start categorizing your Icons, you'll want to use the
  303.           Librarian "move" function.   All you need to do to move an icon
  304.           to another library is to grab (click and hold the left mouse
  305.           button) and then drag the icon to the new library.  This can be
  306.           accomplished in the following ways:
  307.  
  308.                1.   drop the icon in another open library window.
  309.  
  310.                2.   drop the icon on a closed library's "folder" in the
  311.                     main window.
  312.  
  313.                3.   drop the icon on an open library's minimized icon.
  314.  
  315.  
  316.           Note: You can rearrange icons in a window by dropping them in
  317.                 another position within that window.
  318.  
  319.           Note: To make a copy of an icon, simply hold down the control
  320.                 key while dropping the icon.
  321.  
  322.           Note: To move multiple icons, hold down the SHIFT key while
  323.                 clicking on each icon to "mark" them.
  324.  
  325.  
  326.  
  327.                                   Using the Toolbar
  328.                                   -----------------
  329.  
  330.  
  331.                You use the Toolbar functions by dragging and then dropping
  332.           an icon on any of the Toolbar icons.  These tools perform the
  333.           following functions:
  334.  
  335.  
  336.                                The Text Clipboard Tool
  337.                                -----------------------
  338.  
  339.                Dropping an icon on the text clipboard will cause two things
  340.           to happen.
  341.  
  342.                1.   The icon will be saved as a .ICO file with a unique
  343.                     name in your \ICONLIB\IN_USE subdirectory.
  344.  
  345.                2.   The NAME of that icon file will be copied to the
  346.                     Windows clipboard.
  347.  
  348.  
  349.                You're probably saying  to yourself "OK,  so what does  this
  350.           buy me?".  If you think  about it, how does Windows normally  ask
  351.           you for an Icon?  That's right -- by the FILENAME.   That's where
  352.           the Librarian really shines.  Any time you are asked for an  Icon
  353.           name (for example, in the "Change icon" dialog box in the Program
  354.           Manager), you can simply open up the Librarian, find the icon you
  355.           want, and the drag  it to the "Text  Clipboard" icon.  This  will
  356.           cause the icon to  be "extracted" and then  copy the FILENAME  of
  357.           the icon to the Windows Clipboard.   Then you just return to your
  358.           text input box, press SHIFT-INSERT, and the full filename of  the
  359.           icon will be pasted into the text box.
  360.  
  361.                Let's take a normal example -- changing the icon of a
  362.           Program Manager item.    Here's the steps you'd take:
  363.  
  364.                    1.   Start the Icon Librarian, and then "minimize" it to
  365.                         an Icon.
  366.  
  367.                    2.   Single click on the item you want to change the
  368.                         icon for in the Program Manager.
  369.  
  370.                    3.   Choose "File / Properties" from the Program Manager
  371.                         menu bar.
  372.  
  373.                    4.   Click on the "Change Icon" button.  (Notice here
  374.                         that the icon's filename is already highlighted).
  375.  
  376.                    5.   Double-click on the Icon Librarian icon to bring it
  377.                         back to life.
  378.  
  379.  
  380.  
  381.                    6.   Find the Icon you want to select, and then drag
  382.                         and drop it on the "Text Clipboard" icon.  The
  383.                         Librarian will beep once to let you know the name
  384.                         has been copied into the clipboard.
  385.  
  386.                    7.   Minimize the Icon Librarian again; this will return
  387.                         you to the Program Manager "change icon" dialog
  388.                         box.
  389.  
  390.                    8.   Press SHIFT-INSERT to paste the icon's name into
  391.                         the dialog box.
  392.  
  393.                    9.   Press OK twice -- all done!
  394.  
  395.  
  396.  
  397.  
  398.                               The Image Clipboard Tool
  399.                               ------------------------
  400.  
  401.                Dropping an icon on the Image Clipboard will copy the  image
  402.           of that icon  to the Windows  clipboard.  This  is useful if  you
  403.           want to get the icon into an image editor such as Window's  Paint
  404.           program.
  405.  
  406.  
  407.  
  408.  
  409.                                 The Icon Editor Tool
  410.                                 --------------------
  411.  
  412.                Dropping an icon here will cause the following actions to
  413.           happen:
  414.  
  415.                     1.   The icon will be extracted to a unique name in
  416.                          your \ICONLIB\IN_USE\ directory.
  417.  
  418.                     2.   The icon editor that you have specified will be
  419.                          called so you can edit the icon.
  420.  
  421.                     3.   After you exit your icon editor, The Icon
  422.                          Librarian will reload the icon from the file
  423.                          created in step 1.
  424.  
  425.                     4.   The file created in step 1 will be deleted.
  426.  
  427.  
  428.                Note: The Icon Librarian will be TOTALLY disabled until you
  429.                      exit your icon editor!
  430.  
  431.  
  432.  
  433.                                   The Diskette Tool
  434.                                   -----------------
  435.  
  436.  
  437.                Dropping an icon on this tool allows you to extract the icon
  438.           from the Librarian file  and save it to  disk as a standard  icon
  439.           (.ICO) file.  You will be prompted for the name to save the  file
  440.           under.
  441.  
  442.  
  443.  
  444.                                   The Trashcan Tool
  445.                                   -----------------
  446.  
  447.                Surprise!  Dropping an icon here will delete that icon from
  448.           the library.
  449.  
  450.  
  451.  
  452.  
  453.                                 The Information Tool
  454.                                 --------------------
  455.  
  456.                Dropping an icon here will give you information about both
  457.           the icon you dropped and the library in which that icon resides.
  458.  
  459.  
  460.  
  461.                 Tips: Moving Your LIBRARIAN to a Different Hard Drive
  462.                 -----------------------------------------------------
  463.  
  464.              If you ever need to move  your \ICONLIB\ directory to  another
  465.           hard drive,  there's  only  a little  work  involved.    In  this
  466.           example, we'll  assume that  you're moving  it from  drive C:  to
  467.           drive E:.  You would perform these steps:
  468.  
  469.                    1.   Exit Windows.
  470.  
  471.                    2.   XCOPY c:\IconLib\*.* e:\IconLib\*.* /s /e
  472.  
  473.                    3.   Delete the c:\IconLib directory.
  474.  
  475.                    4.   Edit the WIN.INI file in your \WINDOWS\ directory.
  476.  
  477.                    5.   In the [The Icon Librarian] section, change
  478.  
  479.                               Path=C:\IconLib
  480.                                     to
  481.                               Path=E:\IconLib
  482.  
  483.  
  484.  
  485.                     Tips: Exchanging Libraries With Other People
  486.                     --------------------------------------------
  487.  
  488.           If you download or in some other way receive some .TIL files that
  489.           you want to install with your  own libraries, here are the  steps
  490.           you will need to take:
  491.  
  492.  
  493.                     1.   Copy the .TIL file(s) that you have received into
  494.                          your \ICONLIB\ directory.
  495.  
  496.                     2.   Write down the filenames of the libraries.
  497.  
  498.                     3.   Start up The Icon Librarian, and choose the
  499.                          "File / New Folder" option.
  500.  
  501.                     4.   In the "filename" field, key in the name of the
  502.                          file that you wrote down in step 2 above.  Don't
  503.                          key in the extension; it will always be .TIL.  In
  504.                          other words, if the file is named CARTOONS.TIL,
  505.                          then key in "Cartoons" in the filename field.
  506.  
  507.                     5.   Double click on the new library's folder, and the
  508.                          icons will appear.
  509.  
  510.  
  511.  
  512.                                     In Conclusion
  513.                                     -------------
  514.  
  515.  
  516.           I hope that you will enjoy using The Icon Librarian, and that  it
  517.           will help  make your  job of  icon collection  much easier.    As
  518.           always, I  would  appreciate  hearing  your  comments  about  the
  519.           program or suggestions for new ideas that you may have.
  520.  
  521.  
  522.           You can contact  me in any  of the ways  documented on the  title
  523.           page of this  document.    And,  thanks again  for supporting  my
  524.           Shareware products!
  525.  
  526.  
  527.                Keith Ledbetter